home *** CD-ROM | disk | FTP | other *** search
Wrap
ssssyyyyssssiiiinnnnffffoooo((((2222)))) ssssyyyyssssiiiinnnnffffoooo((((2222)))) NNNNAAAAMMMMEEEE _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo - get and set system information strings SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee <_ssss_yyyy_ssss_////_ssss_yyyy_ssss_tttt_eeee_mmmm_iiii_nnnn_ffff_oooo_...._hhhh> _llll_oooo_nnnn_gggg _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo _((((_iiii_nnnn_tttt _cccc_oooo_mmmm_mmmm_aaaa_nnnn_dddd_,,,, _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_,,,, _llll_oooo_nnnn_gggg _cccc_oooo_uuuu_nnnn_tttt_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo copies information relating to the UNIX system on which the process is executing into the buffer pointed to by _b_u_f; _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo can also set certain information where appropriate _c_o_m_m_a_n_d_s are available. _c_o_u_n_t is the size of the buffer. The POSIX P1003.1 interface _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff [see _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(2)] provides a similar class of configuration information, but returns an integer rather than a string. The _c_o_m_m_a_n_ds available are: _SSSS_IIII______SSSS_YYYY_SSSS_NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee [see _uuuu_nnnn_aaaa_mmmm_eeee(2)] in the _s_y_s_n_a_m_e field. This is the name of the implementation of the operating system, for example, _S_y_s_t_e_m _V or _U_T_S. _SSSS_IIII______HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string that names the present host machine. This is the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _n_o_d_e_n_a_m_e field. This hostname or nodename is often the name the machine is known by locally. The _h_o_s_t_n_a_m_e is the name of this machine as a node in some network; different networks may have different names for the node, but presenting the nodename to the appropriate network Directory or name-to-address mapping service should produce a transport end point address. The name may not be fully qualified. Internet host names may be up to 256 bytes in length (plus the terminating null). _SSSS_IIII______SSSS_EEEE_TTTT______HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE Copy the null-terminated contents of the array pointed to by _b_u_f into the string maintained by the kernel whose value will be returned by succeeding calls to _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo with the command _SSSS_IIII______HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE. This command requires that the effective-user-id be super-user. _SSSS_IIII______RRRR_EEEE_LLLL_EEEE_AAAA_SSSS_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _r_e_l_e_a_s_e field. Typical values might be _4._0 or _3._2. PPPPaaaaggggeeee 1111 ssssyyyyssssiiiinnnnffffoooo((((2222)))) ssssyyyyssssiiiinnnnffffoooo((((2222)))) _SSSS_IIII______VVVV_EEEE_RRRR_SSSS_IIII_OOOO_NNNN Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _v_e_r_s_i_o_n field. The syntax and semantics of this string are defined by the system provider. Under IRIX, this is the date and time that the system was generated and has the form mmmmmmmmddddddddhhhhhhhhmmmmmmmm. _SSSS_IIII______MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _m_a_c_h_i_n_e field, for example, _I_P_2_7 or _I_P_3_0. _SSSS_IIII______AAAA_RRRR_CCCC_HHHH_IIII_TTTT_EEEE_CCCC_TTTT_UUUU_RRRR_EEEE Copy into the array pointed to by _b_u_f a string describing the instruction set architecture of the current system, for example, _M_I_P_S-_I_I, _m_3_2_1_0_0, or _i_8_0_4_8_6. These names may not match predefined names in the C language compilation system. _SSSS_IIII______HHHH_WWWW______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR Copies the name of the hardware manufacturer into the array pointed to by _b_u_f. _SSSS_IIII______HHHH_WWWW______SSSS_EEEE_RRRR_IIII_AAAA_LLLL Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the 32 bit hardware-specific identifier of the physical machine on which the system call is executed. Note that this may be implemented in Read- Only Memory, via software constants set when building the operating system, or by other means, and may contain non- numeric characters. It is anticipated that manufacturers will not issue the same ``32-bit identifier'' to more than one physical machine. The pair of strings returned by _SSSS_IIII______HHHH_WWWW______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR and _SSSS_IIII______HHHH_WWWW______SSSS_EEEE_RRRR_IIII_AAAA_LLLL is likely to be unique across all vendor's System V implementations. _SSSS_IIII______SSSS_RRRR_PPPP_CCCC______DDDD_OOOO_MMMM_AAAA_IIII_NNNN This command is not supported under _I_R_I_X. _SSSS_IIII______SSSS_EEEE_TTTT______SSSS_RRRR_PPPP_CCCC______DDDD_OOOO_MMMM_AAAA_IIII_NNNN This command is not supported under _I_R_I_X. _SSSS_IIII______IIII_NNNN_IIII_TTTT_TTTT_AAAA_BBBB______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string that is the pathname of the _iiii_nnnn_iiii_tttt_tttt_aaaa_bbbb file used by the currently running bootable operating system. This is the same as the file specified by the _IIII_NNNN_IIII_TTTT_TTTT_AAAA_BBBB keyword found in the _ssss_yyyy_ssss_tttt_eeee_mmmm file [see _ssss_yyyy_ssss_tttt_eeee_mmmm(4)]. ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______VVVV_EEEE_NNNN_DDDD_OOOO_RRRR Copy into the array pointed to by _b_u_f a string which is the name of the company providing the system. The vendor is the company actually selling the product rather than the company which built the product. Eg: "Silicon Graphics Inc". PPPPaaaaggggeeee 2222 ssssyyyyssssiiiinnnnffffoooo((((2222)))) ssssyyyyssssiiiinnnnffffoooo((((2222)))) ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______OOOO_SSSS______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR Copy into the array pointed to by _b_u_f a string which is the name of the company providing the operating system. This is the name of the company which built the operating system. Eg: "Silicon Graphics Inc". ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______OOOO_SSSS______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string which is the name of the operating system. Eg: "IRIX". ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______HHHH_WWWW______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string which is the name of the hardware platform. This is the name of the platform in the pricelist. Eg: "IP19" ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______NNNN_UUUU_MMMM______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the number of configured processors. Eg: "16" ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______HHHH_OOOO_SSSS_TTTT_IIII_DDDD Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the host id in hex. This example uses sgi.sgi.com, which has an internet address of 192.26.75.5. Eg: "c01a4b05" ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______OOOO_SSSS_RRRR_EEEE_LLLL______MMMM_AAAA_JJJJ Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS major release number. ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______OOOO_SSSS_RRRR_EEEE_LLLL______MMMM_IIII_NNNN Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS minor release number. ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______OOOO_SSSS_RRRR_EEEE_LLLL______PPPP_AAAA_TTTT_CCCC_HHHH Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS patch release number. ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the processor type. In the case of a multiprocessor, this will be a comma separated list with _MIPS_SI_NUM_PROCESSORS entries. ______MMMM_IIII_PPPP_SSSS______SSSS_IIII______AAAA_VVVV_AAAA_IIII_LLLL______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the number of processors available for running unrestricted processes. _ssss_yyyy_ssss_iiii_nnnn_ffff_oooo fails if one or both of the following are true: PPPPaaaaggggeeee 3333 ssssyyyyssssiiiinnnnffffoooo((((2222)))) ssssyyyyssssiiiinnnnffffoooo((((2222)))) _EEEE_PPPP_EEEE_RRRR_MMMM The process does not have appropriate privilege for a SET command. _EEEE_IIII_NNNN_VVVV_AAAA_LLLL _b_u_f does not point to a valid address, or the data for a SET command exceeds the limits established by the implementation. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS Upon successful completion, the value returned indicates the buffer size in bytes required to hold the complete value and the terminating null character. If this value is no greater than the value passed in _c_o_u_n_t, the entire string was copied; if this value is greater than _c_o_u_n_t, the string copied into _b_u_f has been truncated to _c_o_u_n_t-_1 bytes plus a terminating null character. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error. UUUUSSSSAAAAGGGGEEEE There is in many cases no corresponding programmatic interface to set these values; such strings are typically settable only by the system administrator modifying entries in the _mmmm_aaaa_ssss_tttt_eeee_rrrr_...._dddd directory or the code provided by the particular OEM reading a serial number or code out of read-only memory, or hard-coded in the version of the operating system. A good starting guess for _c_o_u_n_t is 257, which is likely to cover all strings returned by this interface in typical installations. SSSSEEEEEEEE AAAALLLLSSSSOOOO _uuuu_nnnn_aaaa_mmmm_eeee(2), _gggg_eeee_tttt_hhhh_oooo_ssss_tttt_nnnn_aaaa_mmmm_eeee(3), _gggg_eeee_tttt_hhhh_oooo_ssss_tttt_iiii_dddd(3), _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C) PPPPaaaaggggeeee 4444